home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / util / gnu / textutils_1_3.LHA / textutils-1.3 / cat / split.1 < prev    next >
Text File  |  1992-09-22  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. SPLIT(1L)         MISC. REFERENCE MANUAL PAGES          SPLIT(1L)
  5.  
  6.  
  7.  
  8. NAME
  9.      split - split a file into pieces
  10.  
  11. SYNOPSIS
  12.      split [-lines] [-l lines] [-b  bytes[bkm]]  [-C  bytes[bkm]]
  13.      [--lines=lines]         [--bytes=bytes[bkm]]        [--line-
  14.      bytes=bytes[bkm]] [infile [outfile-prefix]]
  15.  
  16. DESCRIPTION
  17.      This manual page documents the GNU version of split.   split
  18.      creates one or more output files (as many as necessary) con-
  19.      taining consecutive sections of the _i_n_f_i_l_e, or the  standard
  20.      input  if  none  is  given  or  the  name  `-' is given.  By
  21.      default, split puts 1000 lines of the input file,  or  what-
  22.      ever is left if it is less than that, into each output file.
  23.  
  24.      The output file names consist of  a  prefix  followed  by  a
  25.      group  of  letters,  chosen so that concatenating the output
  26.      files in sorted order by file  name  produces  the  original
  27.      input  file,  in order.  The default output file name prefix
  28.      is `x'.  If the _o_u_t_f_i_l_e-_p_r_e_f_i_x argument is given, it is used
  29.      as the output file name prefix instead.
  30.  
  31.   OPTIONS
  32.      -_l_i_n_e_s, -_l _l_i_n_e_s, --_l_i_n_e_s=_l_i_n_e_s
  33.           Put _l_i_n_e_s lines of the  input  file  into  each  output
  34.           file.
  35.  
  36.      -_b _b_y_t_e_s[_b_k_m], --_b_y_t_e_s=_b_y_t_e_s[_b_k_m]
  37.           Put _b_y_t_e_s bytes of the  input  file  into  each  output
  38.           file.   _b_y_t_e_s is a nonzero integer, optionally followed
  39.           by one of the following characters to  specify  a  dif-
  40.           ferent unit.
  41.  
  42.           b    512-byte blocks.
  43.  
  44.           k    1-kilobyte blocks.
  45.  
  46.           m    1-megabyte blocks.
  47.  
  48.      -_C _b_y_t_e_s[_b_k_m], --_l_i_n_e-_b_y_t_e_s=_b_y_t_e_s[_b_k_m]
  49.           Put into each output file as many complete lines of the
  50.           input  file  as  is  possible  without  exceeding _b_y_t_e_s
  51.           bytes.  If a line  that  is  longer  than  _b_y_t_e_s  bytes
  52.           occurs,  put  _b_y_t_e_s  bytes  of it into each output file
  53.           until less than _b_y_t_e_s bytes of the line are left,  then
  54.           continue  normally.   _b_y_t_e_s  has the same format as for
  55.           the --_b_y_t_e_s option.
  56.  
  57.      The long-named options can be introduced with `+' as well as
  58.      `--',  for compatibility with previous releases.  Eventually
  59.      support for `+' will be removed, because it is  incompatible
  60.  
  61.  
  62.  
  63. Sun Release 4.1           Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SPLIT(1L)         MISC. REFERENCE MANUAL PAGES          SPLIT(1L)
  71.  
  72.  
  73.  
  74.      with the POSIX.2 standard.
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sun Release 4.1           Last change:                          2
  130.  
  131.  
  132.  
  133.